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Overview 

Content on the Next Generation internet needs to be highly adaptive. New interfaces and devices 
are emei^ing, the diversity of users is increasing, machines are acting more and more on users- 
behalf, and net activities are possible for a wide range of business, leisure, education, and 
research activities. 



To achieve maximum flexibility and reuse, content needs to be broken down into richly tagged 
ftagmenis that can be combined and rendered appropriately for the user, task, and context. The 
Franklin content management prototype builds on this premise. It provides an end-lo-end proce 
from content creation and meta-tagging to quality assurance and publishing. 

Franklin integrates several IBM technologies for its five components: content store, meta-data 
store, dispatcher, services and user interfaces. A high-level view of the components' is shovm in 
Figure 1 : Franklin Components. 




Ffgare 1: Frankltn Compoacnts 
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The content store builds upon the Daedalus (a,k.a Trigger Monitor) technology from IBM 
Watson Research. [For ftill specification, see 

http://w3.walson.ibm.com/-challn gr/papers/daedalus/index.htmf ] r>aedalus is designed to 
manage high numbers of rapidly changing content fragments. By maintaining an Object 
Dependency Graph, and by detecting changes to content, it manages pages on a web server or 
cached in a network router in a timely manner. 

The meta-data store manages tags that describe the functional and semantic role of each content 
fragment within the information collection. They may describe what the content is about, who 
the target audience is, and its relationship to a taxonomy or other fragments. The meta-data store 
also supports efficient searches. 

Networked services support the editor in content creation. They may assist the editor in meta- 
data creation, classification, summarization or translation. Instead of doing the task from 
beginning to end, the editor can accept, reject or modify the suggestions created by a service. 

The dispatcher's task is to delegate incoming requests to the content store, meta-data store and 
the services. The dispatcher presents a consistent apph'cation programming interface to the user 
interfaces. This Franklin API abides to the Web protocol for Distributed Authoring and 
Versioning (WebDA V) and to the Distributed Authoring Search Language (DASL) 
specification. 

The user interfaces communicate with the Franklin system through the API. Using the Editor Ul. 
an editor can create and edit XML content fragments, upload XSL style sheets and multimedia 
objects, compose pages out of fragments, preview pages, review final published pages, and reject 
them or promote them to tlie final stage in the publishing flow. 

The Franklin system has also been integrated with KittyHawk, an IBM Notes based workflow 
engine. This workflow module can be turned on or off depending on the application needs. 

This document describes in detail the system requirements and setup, the architecture, 
components and features of Franklin. It covers the lessons learned, and provides a working 
example of a content collection managed with Franklin. In addition, it describes a lightweight 
version of Franklin, code-named Franklin Light, which satisfies the needs of small sites with no 
need for multiple Quality Assurance steps, or a scalable DB2 based search. 

System Setup & Configuration 

Before running an instance of Franklin to manage the content for a web site, you need to 
complete a number of installation steps. You also need to define the DTDs, the XSL style sheets, 
and the site map of the web site you intend to manage. This section outlines the required steps. 

Step 1 : Install Franklin Server 

The Franklin Server runs on an AIX or NT server and requires the following software installed 
on the same machine: 

- Apache Web Server v, 1 . 3 .6 or higher 

- WebSphere Application Server v.2.0 or higher 

- Java run-time environment 1 . 1 .8 
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The Franklin server is distributed as ajar file, i.e.. Franklin jar. The distribution directory 
I J^ontains the following jar files that are required by Franklin: xml4j jar, patbin 1 32 jar, 
I daedaius.jar, lotusxsl.jar, xercesjar. 

Download the Franklin Server and associated components from 

http://franklin.adtech.intemetibm.com/franlclin/downloads/index.html and place them in 
directory accessible by the WebSphere Application Server. 

Step 2: Install DB2 for Meta-Data Store 

The DB2 database used by the Meta-dala Store can run on the same machine or a different 
machine. U requires the following software: 

1) DB2 6. 1 with DB2 XML Extender 7. 1 

Download DB2 XML Extenders 7.1 from FBM software website at 
http://www.software.ibm.com/dh2. Currently, XML Extenders is supported on Windows 
NT, AIX and Solaris. If you decide to use the XML Extender Administration Wi/iurl 
make sure you review the XML Extender Administration Wizard Readme file to ensure 
you have the software prerequisites, JDK 1.1 .x or JRE vl.l.x and JFC LI with Swine I 1 
or later. 

2) JDBC for DB2 JDBC 1.20 

JDBC is included in the DB2 installation (db2java.zip) in the directory of sqllib/java. 

The steps to install DB2 and enable DB2 XML Extenders (which require root authority on AIX): 

1 ) Install a version of UDB higher than 5.2. We have tested DB2 XML on NT for UDB 5.2 
and 6. 1 , and on ADC for UDB 6.1 for DB2 XML XColumn function. 

2) Create a DB2 instance. In the included examples, we use the db2 instance name db2frnkl 

3) Install DB2 XML Extenders 

4) Create a database in the instance. Also, create the tables and indexes based on the sample 
scripts we have provided. 

5) Enable the database with XML Extenders 

6) Start JDBC on a port. For example, "db2jstrt 4000" opens port 4000 for JDBC 
connections. 

Step 3: Customize Server Initialization Files 

^dit JranknnSen^leiInUialization.properties [file and set the following variable to_the desired 
directory in your setup: " ~ " ' ' " ~ — 

baseOir ~ base directory for all Franklin related flies. 

All other variables mfranklinServletlmtializatton.properHes are relative to baseDir^d should 
not be changed; 

dtdDir • directory for DTD and entity files 
xmlDir - root of the directory hierarchy for XML files 



Deleted: 
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assetsDir- directory for all directories browsable by client Ul, i.e. xslDir, pubhshDir, 
multimediaDir 

xslDir - directory for XSL style sheets 

publishDir - root of the directory hierarchy for HTML, HDML or DHTML files 
multimediaDir - root of the directory hierarchy for images, graphics, video and audio 
files 

Edit metastore.ini file and set the folJowing variables to the desired directory in your setup: 

MetaStoreServerIP - database host machine name 
AfetaStoreServerPon - JDBC port number 
MetaStoreServerDBName - database name 
MeiaStoreServerUserlD - database user name 
MetaStoreServerPassword ' dBXdib2LSC password for the above user 
MetaStoreServerDriverClassName - database JDBC driver name 
MetaStoreServerJnitialConnection - number of initial connections to the database 
MetaStoreServerlncremem - number of additional connections to database 
MetaStoreChecklnXMLDir - temporary directory for XML files checked into meta store 
MetaStoreDADDir- directory for DAD files 

MetaStoreCackeSearchDir - directory for cached XML Search results 



Step 4: Configure WebSphere Application Server 

Start the WebSphere Administrative Console, refer to the WebSphere Quick Beginnings guide 
for details 

I . In the Tasks tab of the console, select Configure a Web Application and click the start task 
button 

a. Specify the Web AppI ication Name, e.g., FranklinServer, click Next. 

b. Choose the servlet engine, e.g., the ServletEngine in the Default Server of the Default 
Host, click Next 

a Specify the Web Application Web Path. e.g., /franklinserver, click Next 
d. Specify the CLASSPATH; 

i. Add each of the jar files in the Franklin distribution to the classpath, i.e., fi-anklin.jar, 
daedalus jar, xnil4j jar, lotusxsl.jar, xercesjar, patbin 1 32.zip 

ii. Add the db2java.zip file to the classpath, the db2java.2ip file is distributed with DB2, 
it is found under the sqllib/java subdirectory of the database instance home directory' 

iii. Click Finished 

2. In the same Tasks tab, select Add a Servlet and click the start task button 

a. Select Yes to "Do you want to select an existing Servlet jar file or Directory that contains 
Servlet classes" and click Next 

b. Specify the path of the directory where franklin.jar is located, click Next 

c. Select die Web Application that.was created in the previous step, click Next 

d. Select the Create User-Defined Servlet option, click Next 

e. Specify the Servlet Name, e.g., dispatcher 

f. Specify the Servlet Class Name as com.ibm.adtech.fi:anklin.server.dispatcher.Dispalcher 
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g. Specify the Servlet Web Path List, for example /franklinserver/dispatcher, this Is the web 
path that should be used by the client to access the franklin server, click next 

h. Add an inil parameter with Init Farm Name as baseDir and Init Farm Value equal to the 
directory where the franklin server configuration files are stored, e.g., 
/ftanklin/data/config 

i. Select the True option for Load at Startup; click Finished 

3. The configuration is complete you need to start the service, select the Topology tab 

a. Prior to starting the application, make sure that the database instance is running and that 
jdbc daemon is active (see previous section) 

b. Kxpand the topology tree and select the newly created application. The application will 
appear under the servlet engine that was selected in step Lb 

c. Right click the selection and on the popup menu select Restart Application 

4, The Franklin Server should be available at this point. In order to verify that everything is in 
order view the log files of WebSphere 

Step 5: Install Franklin Client 

The Franklin Client Java Application has been tested on Windows98/2000/NT. 

Download the Franklin Client Application Installer franklinEditor.exe from 
http://franklin.adtech.intemetibm.com/franklin/downloads/index.html and run it. In addition to 
the Franklin Client, the following Java packages are required and are automatically installed by 
the Installer: 

- Java 1-1.8 run-time environment with Swing JFCLLl 

- XMIAS package 
WebDav package 

The Frankhn Client Application Installer also creates the subdirectories required by the client 
under the chosen installation directory. You can change these directories as described in the next 
paragraph- 
After installation, customize the initialization fiiGfrankJm.properties located in the root directory 
where you installed the Franklin Client application. You need to edit the variable browserPath to 
define the location of the web browser you wish to use to preview pages. Also, you can edit the 
variable tempDir if you wish to change the directory where temporary files are|||^ 

dispatcher http://adtech ibmus2. ibm. com/franklinservlet/ 

inUXiVfLFile = xmi/frankJin_iniLxml 

m modify browserPaih to point to the web browser you wish to use for preview 
browserPath = c:/Program Files/irttermt Explorer/iexplore.exe 

nn modify tempDir to point to the directory where temporary files wiU be stored 

tempDir = ,/tmp/ 

(empMediaDir = media/ 

tempHTMLDir hirrd/ 
tempXSLDir = xsl/ 

standcdoneP = false 

validate P = true 
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Step 6: Define Document Type Definitions (DTD) 

Franklin manages two types of content objects, fragments and set-vables. 

A fragment is a content object that can be reused on several pages: 

- a simple fragment is a self contained XML file containing text data and metadata - for 
example, a product specification 

- a compound fragment is an XML file that contains metadata and points to an 
accompanying file such as a video or image file, an XSL style sheet, or a hand-crafted 
HTML page 

- an index fragment is an automatically updated XML file that indexes any number of 
servables - for example a panel listing the five latest press release [Future: index 
fragments not available in current implementation] 

A servable is an XML file thai contains the text and meta-data for one final published page and 
imports reusable content from one or more fragments, and points to one of more style sheet 
fragments. 

Figure 2 shows a product page servable which includes content from six fragments, namely 
three text fragments, one image fragment and tvi^o style sheet fragments, and results in two final 
published pages. 

Insert Figure 2 here 

Befoi^ beginning to manage a content collection, you need to define the document type 
definitions, or DTDs, for each class of fragment and servable that will be managed by the 
application. Franklin uses the syntax of DTDs to define a document type. [See the XML 
specification at http://wwu\ w3.org/TR/REC-xml] 

In order for Franklin to manage DTDs conrectly, all DTDs must abide to the Franklin following 
specifications: 

Franklin specification of fragment and servable DTDs 

1 . The root element, to which you can give a meaningfiil name, must have a child node called 
SYSTEM with the children nodes FRAGMENTID, creator, modifier, creationtime, 

LASTMODIFIEDTIME, PAGETYPK: and CONTENTSIZE. The NAME attribute of PAGET YPE must be 

set to either "fragment" or "sekvable". 

<!ELErfENT ROOT {SYSTEM, ...) > 

<!ELEMENT SYSTEM ( TlvAGMENTID, 

CREATIONTIME, 
LASTMODIFIEDTIME, 
CREATOR, 
MODiri ER, 

CONTENTSIZE?) > 
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<! ELEMENT FRAGMENTID 

< ! ELEMENT CREATIONTIME 

<! ELEMENT LASTMODIFIEDTTME 



(#PCDATA>> 
(# PCDATA) > 
(# PCDATA) > 
(#PCDATA) > 
(# PC DATA) > 
(# PC DATA) > 
(# PCDATA) > 



<! ELEMENT CREATOR 
<.'ELEI-rENT MODIFIER 



<! ELEMENT CONTENTSIZE 



<!ELEMEKT PAGETYPE 
<!ATTLIST PAGETYPE 



NAME (FRAGMENT! SERVABLE) "FRAGMENT" #FIXED> 



2. All items editable in the Editor Ul need to be elements of the DTD, not attributes. For 
example^ 



3. All elements to be indexed for search must be oKvpe PCDATA, and must contain the 
attribute SEARCH set to YES. For example. 



Future: Need to add SEARCH attribute. Hie SEARCH attribute will allow Franklin to 
automatically generate the DAD mapping for the DB2 XML Extenders.. 



4. Include the external entity reference that defines the user interface widgets recognized by the 
Franklin Editor UT. Each element that needs to be editable in the Editor UI must be of type 
PCDATA and contain the DATATYPE attribute set to the appropriate UI type. 

<! ENTITY % UITYPES SYSTEM 

"http: //franklinserver/franklln/dtd/uitypea . txt"> 



If you wish a LONGTEXT widget to allow an editor to enter a limited set of HTML tags add the 
PARSE attribute and set it to true. The supported HTML are: 

<P>, <ul>, <ol>, <sl>, <;dl>, <dt>, <dd>, <li>, <div> 
The file uitypes,txt is fixed and provided in the FrankI in install in the dtdDir in the 
Jrankiin.properties file. It contains the list of all UI widgets known to the Editor Ul. (See section 
Editor UT Widgets for a detailed description of UITYPES) 

DATE I INTEGER | STRING | SHORTTEXT \ LONGTEXT | CHOICE | BROWSESERVER I 
BROWS SLOCAL I ASSQCLIST 



<! ELEMENT TITLE (# PCDATA ) > 

<!eLE^!ENT SHORTDESCRIPTIOM (# PCDATA ) > 
<! ELEMENT CATEGORY f ft PCDATA ) > 




<!ATTLI3T TITLE DATATYPE (%UITYPES;) 

<!ATTLIST SHORTDESCRl PTION DATAYTPE (%UITY?E3;) 

PARSE (TRUE) 



"STRING" 

"LONGTEXT' 
"TRUE" 



#F1XED> 

#FIXED 

#FIXED> 
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5. An element can appear as a drop-down menu in the Editor UT and restrict the editor to choose 
the value from a predefined set. To accomplish this, set the DATATYPE attribute to the 
UITYPE "CHOICE'; and the CHOICES attribute to a default value from a list of options. The 
options can be defined as an external entity for reuse across many DTi:)s. 

<! ENTITY % CATEGGRYDEFS SYSTEM 

"http: //frankXinserver/f ranklin/citci/categorydefs.txfc"> 

<!ATTLIST CATEGORY DATATYPE (%UITYPBS;) "CHOICE" #FIXED 

CHOrCeS (%CATEG0RYDEFS; ) "NONE" #REQUIRED> 

For example, the options for category could be defined as the types of Netfinity servers: 

NONE I Metfinity_8500R i Metf inity_7000_M10 | Netfinity 5500 MIO | 
Netfinity_5 600 | Net f iaity_5500 ~ ~ 

The Editor Ul assumes that if the first word in the set of CHOICES is the string NONE, and the 
editor selects it, the element wii) not appear in the XML document 

6. A fragment can include other fragments as subftagments. If so, the entity reference that 
defines all subfragm^i types must be included in the DTD. The declaration of a subfragment 
must contain the subfragmenttype attribute set to the appropriate type. 

<! ENTITY % SUBFRAGMENTTYPES SYSTEM 

"http: / /f ranklinserver/ f ranklin/dtd/subf ragmenttypes . txt^> 
<i ELEMENT SUBFRAGMKNT (<f PCDATA) > 

<!ATTLIST SUBFRAGMENT SUBFRAGMENTTYPE (%SUBFRAGMENTTYPES; ) IMAGEFRAGMENT" 
#FIXED> 

Future: the subfragment syntax will be replaced by the XLink syntax once it becomes a W3 
recommendation and XMI.4J and LotusXSL support the syntax. Until then, we wUl use 
subfragment elements as way to include content from another fragment. 

An example of a fragment DTD, listfi^gmentdtd: 

<: ENTITY % SUBFRAGMENTTYPES SYSTEM 

"http://franklinserver/f ranklin/dtd/subf ragmenttypes. txt"> 
<! ENTITY % CATEGORYDEFS SYSTEM 

"http: //f ranklinserver/f lankiin/dtd/categorydef 3 .txf •> 
<! ENTITY % UITYPES SYSTEM 

"http: //franklinsei:ver/franklin/dtd/uitypes.txt"> 

<! ELEMENT USTFRAGMENT (SYSTEM, TITLE, SHORTDESCRIPTION?, CATEGORY* 

LISTITEM+) > ' 

<!ELEMENT SYSTEM tFRAGMENTID, CREATOR, MODIFIER, CREATIONTIME, 

LASTMODIFIEDTIME, PAGET YPE, CONTENT SI 2E'' ) > 

<f ELEMENT FRAGMENTID (5 PCDATA) > 

<! ELEMENT CREATI0N7IKS (# PCDATA) > 

< I ELEMENT LASTMODI FI EDTIME (#PCDATA)> 

<1 ELEMENT CONTENTS IZE (fr PCDATA )> 

<! ELEMENT CREATOR (ftPCDATA)> 

<! ELEMENT MODIFIER (# PCDATA )> 

<i ELEMENT PAGETYPE (#PCDATA)> 

<» ELEMENT TITLE (# PCDATA )> 

< 'ELEMENT SHORTDESCRIPTION (#PCDATAJ> 
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<! ELEMENT CATEGORY 
<* ELEMENT LISTITEM 
<! ELEMENT LISTTITLE 
<! ELEMENT DESCRIPTION 
<! ELEMENT LINK 
<! ELEMENT FOOTNOTE 

<!ATTLIST TITLE 



DESCRIE>TION?» LINK?, FOOTNOTE?) > 



f# PCDATA) > 
(LISTTITLE?, 
(# PCDATA ) > 
f# PCDATA ) > 
{# PCDATA) > 
PCDATA) > 



DATATYPE (%LHTYPBS;) #FIXED 
SEARCH (YES I NO) "YES" #FIXED> 



<!ATTLIST 
<!ATTLIST 



< lATTLIST 
<!ATTLIST 
<!ATTLISr 
<IATTLIST 



SHORTDESCRIPTION DATATYPE 
SEARCH 



CATEGORY 



LISTTITLE 

DESCRIPTION 

LINK 

FOOTNOTE 



f%UITYPES;) «FIXED 
(YES I NO) "YES" #FIXED> 
DATATYPE (%UITYPES;) #FIXED 
CHOICES (%CATEGORYDEFS;) #IMPLTED 
SEARCH (YESINO) "YES" #FIXED> 
DATATYPE (%UXTYPES;) #FIXED 
DATATYPE {%PITYPES;) # FIXED 

DATATYPE {%UITYPES;) #FIXED 
DATATYPE f%UITYPES;) #FIXED 



"STRING" 

"SHORTTEXT" 
"CHOICE" 



"STRING"> 
"STRING"> 
"STRING"> 
"STRING"> 



Franklin specification of compound fragment DTDs 

A compound fragment contains a pointer to an accompanying file, such as a multimedia file, an 
XSL style sheet or a hand-crafted HTML file (i.e. ones that are not generated from XML by* 
Franklin) The accompanying file is encoded as a binary object into the fragment for the duration 
of the communication between Editor Ul and Franklin Server. Before check-in to the server, the 
Editor UI encodes tiie file as a binary object into the XML fi-agment. At the receiving end. the 
dispatcher extracts it and decodes into the original format. The reverse happens at check-out. 
This allows a single communication between the client and server when exchanging this type of 
fragments. 

1 . A compound fragment DTD must use the following syntax to declare the inclusion of an 
external file: 

<• ELEMENT CONTENT " t#PCDATA) > 

<! ELEMENT CONTENTDIR (# PCDATA ) > 

<! ELEMENT CONTENTFILENAME , (#PCDATA}> 

<!ATTLTST CONTENT DATATYPE £%UITYPES;) #FIXED •'STRING"> 

<!ATTLIST CONTENTDIR DATATYPE (^UITYPES;) #FIXED "BROWSES ERVER"> 

<1ATTLIST CONTENTFILENAME DATATYPE (%UITYPES;) #FIXED "BROWS ELOCAL"> 



Franklin specification of group index fragment DTDs 
Funjre: To be filled in 

Franklin specification of aervable DTDs 

In the Franklin system, servables always result in one of more final published pages. The DTD 
must indicate the names of the XSL style sheets it can use for layout and where to pubiish the 
resulting pages. 
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1. A servable DTD must contain the following decJarations: 

PUBLISKDTR, PUBLISHFILENAME) > 



<! ELEMENT PDHLISHINFO 
<! ELEMENT STYLESHERT 
<! ELEMENT PUBLISHDIR 
<! ELEMENT PUBLISHFI LENAME 
<!ATTLIST STYLESHEET 



{STYLESHEET, 
{# PCDATA) > 
(# PCDATA) > 
(# PCDATA) > 
DATATYPE { %UITYPES ; 



) »nXED "CHOICE- 



CHOICES (styleshheetl.xsl|stylesheet2.xsi; #tmplieD> 



<!ATTLIST PUBLJSHDTR DATATYPE 
<iATTLIST PUBLTSHflLENAME DATATYPE 



(%UITYPES; } 
(%UITYPES; ) 



*f FIXED 
ff FIXED 



•BROWSESERVER"> 
*STRING"> 



2. A servable can include one or more subfragments. Each subfragmetit serves a specific role 
within the servabJe and can be named in a meaningfiif way, for example iMAINPHOTO, 
HIGHLIGHTS etc. Each subfragment must have an attribute thai indicates the type of ' 
subfragment to include. The syntax to include a subfragment in a servable follows: 



<!ELEMENT MAINPHOTO (#PCDATAJ > 

<! ELEMENT HIGHLTr;HTS (#PCDATA)> 
<!ATTLIST MAINPHOTO DATATYPE (%UITYPES/ ) 

SUBFRAGMENTTYPE ( %SUBFRAGMENTTYPES; ) 
<!ATTLIST HIGHLIGHTS DATATYPE (%UITYPES;) 

SUBFRAGMENTTYPE ( %SUBFRA(;mRNTTYPES; ) 



(fFlXSD "STRING'* 
tnXED ''IMAGEFRAGMENT"> 
ifFIXSD "STRING" 
# FIXED "LJSTFRAGMENT"> 



3. A servable can be included in an automatically generated group index fragment 
To be filled in 

An example of a servable DTD, productpage.dtd: 

<r ENTITY % UNIVERSAJ. SYSTEM 

"http://franklin3erver/franklin/dtd/univer3al.dtd*'> 
<! ENTITY % SUBFRAGMENTTYPES SYSTEM 

"http://franklinserver/franlclin/dtd/3ubfraginenttype3. t xt"> 
<! ENTITY % CATEGORYDEFS SYSTEM 

"http://franklinserver/f ranklin/dtd/categorydefs . txt "> 

<!ELEMENT PRODUCTPAGE (SYSTEM, TITLE, ^ SOURCE?, COMMEWT?, SHORTDESCRIPTION?, 
LOKGDESCRIPTION?, KEYWORD*, CATEGORY*, RELATEDLINK* , ' 
PUBLISHINFO+, BRANDNAVIGATION, MAINPHOTO, GLANCE, 
HIGHLIGHTS , GROUPINDEX* ) > 
<!ELEMENT SYSTEM {.FRAGMENTID, CREATOR, MODIFIER, CREATIONTIME, 

LASTMODIFIEDTIME, PAGETYPE, CONTENTSIZE? ) > 

<! ELEMENT FRAGMENTID (# PCDATA )> 

< I ELEMENT CREATIONTIME (# PCDATA >> 

<! ELEMENT LASTMODIFIEDTIME (#PCDATA)> 

<!ELEMENT C0NTENTSI2S (ftPCDATA)> 

<1 ELEMENT CREATOR (# PCDATA) > 

<!ELEMENT MODIFIER {#PCDATA)> 

'<1ELEMENT PAGETYPE («PCDATA)> 

<! ELEMENT TITLE C#PCDATA)> 

<! ELEMENT SOURCE PCDATA) > 

<! ELEMENT COMMENT {#PCDATA)> 

<! ELEMENT SHORTDESCRIPTION (# PCDATA )> 

<IELEMENT LONGDESCRI PTION (#PCDATA)> 

<! ELEMENT KEYWORD (# PCDATA) > 
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<!SLEMEt>;r CATEGORY 
<! ELEMENT RELATEDLINK 
<! ELEMENT URL 

ELEMENT LTNKTITLE 
<! ELEMENT DOCTYPE 
< ! ELEMENT DTDURL 
<! ELEMENT PUBLISH INFO 
< ! ELEMENT STYLESHEET 
<! ELEMENT PDBLISHDIR 
<!ELEiyrBNT POBLI SHFILENAME 
<!ELEMEWT 3RANDNAVIGATI0N 



<] ELEMENT MAINPHOTO 
<» ELEMENT GLANCE 
<t ELEMENT HIGHLIGHTS 
<! ELEMENT GROUPINDEX 
<!ATTLIST TITLE 
<!ATTLIST SOURCE 
<!ATTLIST COMMENT 
<!ATTLXST SHDRTDESCRIPTION DATATYPE 
<!ATTLI3T LONGDESCRIPTION DATATYPE 
" SHORT TEXT "> 
<!ATTLIST KEYWORD 
<!ATTLIST CATEGORY 



(# PCDATA }> 
(URL, LINKTITLE)> 
(# PCDATA) > 
( if PCDATA ) > 
(# PCDATA) > 
(ft PCDATA) > 
(STYLESHEET, PUBLISHDIR, 
Cfr PCDATA) > 
{# PCDATA ) > 
{#PCDATA) > 
(# PCDATA) > 
(# PCDATA) > 
f# PCDATA) > 
(# PCDATA )> 
(#PCDATA) > 

DATATYPE {%UITYPES;) 
DATATYPE 
DATATYPE 



PUBLISHFILENAME) > 



(%UITYPES 
(%UiTYPES 
( %UITYPES 

r%aiTy?Es 



♦fixed 

#riXED 
FIXED 
# FIXED 

#FIXED 



"STR i:ng"> 

"STRIM(;'*> 

"STRING";- 
"SHORTTEXT"> 



DATATYPE 
DATATYPE 
CHOICES 
DATATYPE 
DATATYPE 
DATATYPE 



(%UITYPES;) 
(^UITYPES;) 
(%CATEGORyDEFS;) 
(%UITVPES; ) 
(%UI TYPES; ) 
;?,DITYPES; ; 



<!ATTLIST URL 
<!ATTHST UNKTITLE 
<IATTLTST BRANDMAVIGATION 

SUBFRAGMENTTYPE ( %SUBFRAGMENTTY?ES ; ) 
<!ATTLIST MAINPHOTO DATATYPE (%UITYPES;) 

SUBFRAGMENTTYPE (% SUBFRAGMENTTYPE S ; ) 
<!ATTLI.ST GLANCE DATATYPE (%UITYPES;) 

SUBFRAGMENTTYPE ( %SDBFRAGMENTTY?ES ; ) 
<fATTLl ST HIGHLIGHTS DATATYPE (%01TYPES;) 

SUBFRAGMENTTYPE ( %SUBFRAGMENTTYPES; ) 
<!ATTLIST STYLESHEET DATATYPE (%UITYPES;) 



♦FIXED "STRING" 

♦ FIXED "CHOTCF." 
#IMPLIED> 

frPlXED "STRIKC," 
# FIXED "STHING" 
# FIXED "STRTKG" 
# FIXED LI ST FRAGMENT" 

♦ FIXED "STR. TNG" 
♦FIXED "IMAGE FRAGMENT "> 

♦FIXED "STRING" 
♦ FIXED "LISTFRAGMENT*'> 
»FIXED "STRING" 
♦FIXED "LISTFRAGMENT"> 
H FIXED "CHOICE" 



CHOICES (web_j>roduct_index,xsi | pda product index. xsl) 
#IMPLIED> ^ 
<!ATTLIST PUBLISHDIR DATATYPE {%UTTYPES;) 
<!ATri.IST PUBLISHFILENAME DATATYPE ( %UITY PES; ) 
<!ATTLI ST GROUPINDEX DATATYPE (%OITYPES;) 

SUBFRAGMENTTYPE (%SUBFRAGMENTTYPES ; } 



♦FIXED "BROWSESERVER"> 
♦ FIXED "STRING*'> 
♦FIXED "STRING" 
S FIXED " GROUPINDEX 



An example of a servable, 2-tsrv.xmI, which abides to productpage.dtd: 

<?xial version="l . 0'*?> 

<!DOCTYPE PRODUCTPAGE SYSTEM "http : // f rankiinserver/dtd/productpage dtd- 
<PRODUCTPAGE> *- ^ - 

<SYSTt:M> 

< FRAGMENT I D>2 - t 5 rv . xml< /FRAGMEN T I D > 
<CREATOR>Joe Moe</CREATOR> 
<MODlFlER>Jdne Mane</MODIFIER> 
<CREATIONTIME>384738740383</CREAT10MTIME> 
<LASTMODIFIEDTIME>384738740383</LASTMODIFIEDTIME> 
<PAGETYPE>Servable</PAGETYPE> 
</SYSTEM> 

<TITLE>Netfinity 8500R</TITLE> 
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<SO0RCE>IBM PC Coinpany</SOURCE> 

<SHORTDESCRXPTION>Mainframe features bring extraordir.c»Ly performance and 
reliability to a rack-optimized 8-way server</SHORTDESCRlPTiON> 

<LONGDESCRIPTION>A great value in 8-way servers, the new Nerfinity 8500R 
maximizes uptime and provides superior manageability for compute-intensive 
business intelligence, transaction processing and server consolidation 
projects. </LONGDESCRiPTrON> 

<KEYWORD>New< /KEYWORD > 

<KEyWORD>Se rver </KE YWORD> 

<KE YWORD> Pent ium< / KEY VJORD> 

<CATEC50Ry>Netfinity a500R</CATEGORY> 

<CATEGORY>Small and Mediun Business</CATEGORY> 

<RELATEDLINK> 

<DRL>f tp : //f tp .pc. ibm. com/pub/pccbbs/pc servers /85O0rf . pdf</URL> 
<LINKTITLE>Mhite paper</LINKTlTLE> 
</RELATEDLINK> 
<PUBLISHINFO> 

<PDBLISHDIR>/web/netf inity/</PDBLISHDIR> 
<PaBLISHFI LENAME>index . html</PUBLISHFILENAM£> 
<STYLES«EET>webproduct_indeK . xsl</STYLESHEET> 
</PDBLISHINFO> 
<PUBLISHINFO> 



<PUBLlSHDIR>/pda/netfinity/</PUBLISHDIR> 
<PUBLISHFlLENAME>index,html</PDBLISHFILENAME> 
<STyLESHEET>pda_product_index.xsI</STYLESHEET> 
</PUBLISHINFO> 

<GROUPlNDEX>4 4 4-ifrg.5anl</GROUPINDEX> 
<MAINPHOTO SOBFRAGMENTT YPE= " I MAGE FRAGMENT "> 

222-bf rg . xml</MAINPHOTO> 
<HTGHLIGHTS SUBFRAGMENTTYPE^ '* LI ST FRAGMENT "> 
4 44-tfrg.xml</HIGHLIGHTS> 
</PRODOCTPAGE> 

Once all DTDs for the collection have been defined, save them in the directory defined by the 
variable dtdDir in the franklin.properties fi le. 

After updating, adding or deleting any DTDs, update the files configDir/dtds.xmi and 
dtdDir/subfragmenttypes.txt to reflect the current DTDs. Also remember to define a DAD file to 
for each DTD. (Future: DAD explanation should be expanded) 



Step?: Define Style Sheets 

For each servable DTD. you need to define one or more XSL style sheets that will be assembled 
with die servable XML and the XML of any subfragments into the finai published pages. A style 
sheet IS written using the XSL syntax to produce HTML, DHTML, HDML or other desired 
output. [See the XSL Transformations syntax at http://www.w3 .crg/TRy^I^ 

Franklin specification of XSL style sheets 



Because the servable includes content from subfragments, the style sheet must be written to work 
on the so-called ejip^zn^fec/ servable. Before page assembly, a servable is temporarily rewritten to 
mclude the content of all its subfragments. Because the XLink standard has not been finalized. 
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XSL style sheets cannot access content stored in subfragment files outside the servable. Franklin 
implements a temporary solution that mimics the XLink functionality by expanding the servable. 
This is demonstrated by the expanded product page 2-tsrv.xml: 

<?xmi ver3ion="3 . 0"?> 
<!DOCTYPE PRODDCTPAGE SYSTEM 

"http: //yourfranklinserveif/dtd/productpage .dtd''> 
< PRODUCT PAG E> 
<SYSTEM> 

<FElAGMENTID>2-tsrv . xml</FRAGMENTID> 
<CREATOR>Joe Koe</CREATOR> 
<MODIFIER>Jane ManG</MODIFIER> 
<CREATIOKTIME>384738740383</CREATIONTIME> 
<LASTMODIFIEDriME>3B4 738740383</LASTMODIFlEDTIME> 
<PAGETYPE>Servable</PAGETYPe> 
</SYSTEM> 

<TITLE>Netfinity 8500R</TITLE> 
<SODRCE>IBM PC Corapany</SOURCE> 

<SHORTDESCRIPTION>Mainfraine features bring extraordinary perforir^nce and 
reliability to a rack-optimized 8-way server</SHORTDESCRlPTION> 

<T.0NGDESCRIPTION>A great value in 8-way servers, the new Netfinity 3500R 
mBxxmxzes uptime and provides superior manageability for compute-intensive 
business intelligence, transaction processing and server consolidation 
projects. </LONGDESCRIPTION> 

< KEYSf ORD>Ke w< / KE YWORD> 

<KEYWORD>Server</KEYWORD> 

<KEYW0RD>PentiuitK/KEYWORD> 

<CATEGORY>Netfinity 8500R</CATEGORY> 

<CAT2G0RY>Small and Medium sines s</CATEGORY> 

<RELATEDLINK> 

<URL>f tp://ftp.pc.ibm.com/pub/pccbba/pc_3ervers/B500rf .pdf</URL> 
<LINKTlTLE>White paper</LINKTITLS> 
</RELATEDLINK> 
<PUBLlSHrNEO> 

<PUBLISHDIR>/web/netfinity/</PaBLiSHDiR> 

<PUBLISHriLENAME>index . htnil</POBLISHFILENAME> 

<STYLESHEET>web_product_index.xsl</STYLESHEET> 
< /PUBLISH INFO 

<PUBLlSHINFO> 

<PaBLISHDIR>/pda/netfinity/</PUBLISHDlR> 

<PUBLISHFILENAME>index.htita</PUBLISHFILENAME> 

<STYLESHEET>pda_product_index . X3l</STYLESHEEt> 
</F^U3LISHINF0> 

<GROUPINDEX>444-ifrg,xml</GROUPINDEX> 
<MAIN PHOTO S UB FRAGMENT TYPE= " IMAGE FRAGMENT " > 
<rMAGBFRAGMEMT> 
<3YSTEM> 

<FRAQtBNTrD>222-bf rg . xiia</FRACa4BNm» 
<CKRATOR>BOB< / CREATOR> 
<MM>IFIER>BOB</MDDIFIER> 

<CREATIONTlMK>3Q 473874 0383</CRBATX0N»lME> 

<IASTKOD 1FZBDT1ME>3847 38 74 0383</IASTbdDDXFIEDTIME> 
<PACETYPE>Fraginant</ pacbtyps> 

<C0KTENTSrZE>4 0 0</CONTENTSI ZE> 
</SYSTEM> 

<TITLEVrhe Netfinity 850 OR large jpog</TITXE> 
<SHORTDESCRIPTrON>KBt£xnity 8500R</SBOIITDESCRIPTION> 
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<CONTENTDi R>/ Images /prod_images/</CONTRNTDlR> 
<CONTENTFILEKftMB>8500R_larg-e . jpg</CONTENTPILBENAME> 
<0ONTEKT/> 
</ IMAGE FRAGMEan'> 
< /MAIN PHOTO 

<HIGHLIGHTS SUIlFKAGMENTTyPE= "LI ST FRAGMENT "> 
<L1S rPRAGMENT> 
<SySTEM> 

<FRAQUSNTID>4 4 4 - tf rg . X3al</PRAGMENTID> 

<CREATOK>BOB</CRSATOR> 

<MODIPIER>BOB</MaDIP12R> 

<CREAXIONTIME>384738740383</CRKATIONTIME> 
<PAGETYPE>Fragmont</PAGKTTPE> 

<J-ASTMODIFIEDTIME>384738740383</IASTMODIPIKDTIME> 

</sysrEM> 

<TITLE>Highlighta o£ the 8500R</TITLS> 
<CATKCORY>Notf i_tiity a500R</C&l!rBGORir> 
<I.I3TITEM> 

<TITLE>lJ.ght-Path Diagnostics</TITLE> 
<BODY>Lighted guidance system to assist in quick 
idantification of failing components, aimilac to th© lights in a copier 
that identify th© location of a paper jaia.</BODT> 
</l.ISTITEM> 
<L1STITEM> 

<nTI.E>Activo PCI technology</TlTi;B> 

<BODY>£nablos XBM's unique hot^add PCI, letting you 
add client systems, balance network traffic or increase storage capacity 
without shutting the system down. </BODr> 
</liISTITEM> 
</lJr STFRAiSMENT > 
</HIGHLIGHTS> 
</PRODC3CTPAGE> 

Any Xpath eKpressions in the style sheet that refer to subfragment content will be local to the 
servable. The following exajnple XSL style sheet, webjjroductjndex.xsl, produces a simpfe 
HTML page by displaying content form the servable as well as the two subfragments: 

<?xinl ver3ion="l . 0"?> 

<xsl: stylesheet xirJ ns : xsl = "http: //www.wS . org/XSL/Trans focm/l . 0"> 

<xsl: teinplaLe match^" product PAGE "> 

<HTML> 

<HEAD> 

<TITLEXxsl :value~of so lect="TITLE"/></TITLE> 

<META NAME='"source-xnU." CONTENT=»" ( SYSTEM/ FRAG^9ENTID| " /> 

<META KAME='*3ourcG-xsI'* CONTENT="web product index. xsi"/> 

</HEAD> 

<BODy> 

<TABLE CELLPADDING="0" CELLSPACrNG="0" BORDER-" 0** WI DTH=" 451 "> 

<TR> 

<TD> 

<! — title section — > 

<FOMT COLOR-"#005399" SlZE="+3" FACE="Tiiiies New Roraan"> 

<X5i ! value-of select="TITLE*/> 

</FONT><BR/><BR/> 
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<! — end title section — > 

<! — short description section — > 

<B><FONT SIZE=''-1" FACE='''Arial"> 

<xsl : value-of select="SHORTDESCRI PTIOK* /> 

</FONr><8R/><BR/></B> 
<!-- end short description section --> 
</TD> 
</TR> 
<:tr> 
<TD> 

<!-- photo section — > 

<IMG HEIGHT=^*'110" WIDTH-"140" C 

SRC-'VmultimedialMAINPHOTO/IMAGEFRAQ^NT/CONTENTDIR} { MAI N PHOTO/ IMA GEFRAGMEN 
T/CONTEKTFILENAME} " BORDER«''0" 

ALT="MAINPHOTO/IMAGEFRAGMENT/SHORTDE55CRIPTION"></IMG> 
<! — end of photo section — > 

</TD> 
</TR> 
</TA31.E> 

<!-- Highlights section — > 

<TAELE 3ORDER="0" CELLS PACING="0 " CELLP;^DDING= " 5" WIDTH=*M51"> 

<Tti> 

<TD C0LSPAN="2" WIDTH=''4 51"> 

<B><FONT SIZE""-1" FACE="Arial''>Higraights of the 
. <x3l : value-of select=**TlTLE"/> 

</FONT></B> 
</TD> 
</TR> 

<xsl : apply-teraplates select='''HIGHLICHTS /LrSTERAGMENT/LIST"/> 
</TABLE> 

<! — End of Highlights section — > 

</BODY> 

</HTM L> 

</xsl :template> 



<xsl : template match=" /PRODUCTPAGE/HIGHLl Gr:TS/LISTFRAGMENT"> 
<x3l: for-each select="LISTITEM''> 

<TR> 

<TD WIDTH="151" VALIGN="TOP"> 

<F0N7 size="-l'' f ace="Arial"><xal : va I ue-of select»="riTLE"/></FONT> 

</TD> 

<TD WTDTfl="300" VALIGN=''*TOP"> 

<rONT si2e="-l" face="Arial"><xsl: value-of select="BODY"/></FONT> 

</TD> 

</TR> 
</xsl : for-each> 
</xsl : template> 
</xsl : stylesheet> 



Once all XSL style sheets for the DTDs have been defined, add them to the CHOICES list of the 
STYLESHEET element in the appropriate DTDs. 

Then, check them in to the /xsl directory using the FrankJin Editor. 
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[Add here, the definition of a debug style sheet, what is should do, and where it should be saved 
on the server] 



Step 8: Create Directory Structure 

Create the directory structure that corresponds to the site map of your appiicarion. Under 
publishDir create the HTML directories, and under multimediaDir the muhimedia directories. 

If your site is published to more than one audience segment or device, define several sibling 
directory stmctures under pnblishDir. For example, a site published for two devices, one for 
browsing all content using a weh browser, and another for browsing oniy the news section usine 
a pda browser^ could have the following directory structure: 

pubiishDirAveb/ 

pubiishDir/web/news/ 

publishDirMeb/producis/ 

publishDir/pda/ 

piiblishDir/pda/news/ 

midtimediaDir/images/ 

muUimediaDir/audio/ 

When an editor authors a servable, the PUBLISHDIR element of the servabfe will be presented 
m the Ul with the BROWSESKR VER widget. This widget allows the editor to browse the 
directory structure under ossetsDir and select where to save the resulting file. Similarly, when 
editing a multimedia object, the widget allows the editor to browse the direaory structi^e to 
select where to save the binary file. 

Step 9: Configure Web Server 

To browse the published sites, set up a web server for each sibling site. Coniigure the Document 
Root variable to point to the top of the directory hierarchy of a sibling site. The example below 
assumes that the baseDir 'mfmnkiinSen^let/nitialization,properfies is set to "/franklin/data/": 

For the example in the previous section, you would set up two web servers: 

Web ServQr 1: DocumentRoor 'Vf ranklin/ddta/publish/web/" 
Web Server 2: DocumentRoot "/f ranklin/data/publish/pda/" 

Also, add the aliases below to the configuration file of Web Server 1 and 2. 
Alias /dtd/ "/franklin/data/dtd/" 
Alias /xsl/ "/franklin/data/assets/Ksl/" 
Alias /multimedia/ "/franklin/data/assets/multimedia/" 
Alias /xml/ "/f rank! in/da t a /xml" 

Set directory browsing "on" so that you can easily browse the DTDs and verify the uploaded 
XML files, XSL style sheets, and multimedia files. 
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Step ID: Define Roles & Users 

Before running the Editor Ul, you need to define the allowed roles and users of the Franklin 
system. A role is defined by the list of DTDs the role is allowed to edit. A user is defined by 
or more roles. 



To define new roles, edit the file configDir/roies.xml by importing the DTD configDir/roles.dtd 
to an XML editor such as Xeena from IBM alphaworks. (Future: use the Editor UI to edit the 
file) 



Ih^UTD roles.dtd: 



<! ELEMENT ROLES 
<! ELEMENT ROLE 
< ! ELEMENT ROLENAME 
<! ELEMENT DTD 



(ROLE*) > 

( ROLENAME , DT O"^ ) > 
(#PCDATA) > 
(#PCDATA) > 



An example roles.xmi defines two roles, FragmenLEditor and Editor and associates the allowed 
DTDs to each: 

<?xml version="1.0" encoding^"UTF-8"'>> 
<ROLES> 

<ROLE> 

<ROLENAME>FragmentE<litor</ROLENAME> 

<DTD>http://franJclin3erver/cltci/textfragnient.dtd</DTD> 
<DTD>http: //f ranJclinserver/dtd/ii 5tf ragment . dtd</DTD> 
<DTD>http: //franklin3erver/dtd/audiofraginent.dtd</DTD> 
<DTD>http: //f ranklinsBrver/dtd/videofragment .dtd</DTD> 

<DTD>http://f ranklinserver/dtd/iniageeraginent.dtd</DTD> 
</ROLE> 
<ROLE> 

<ROLENAME>Editor</ROLENAME> 

<DTD>http://franklin3erver/dtd/textfragment.dtd</DTD> 
<DTD>http; //franJclinserver/dtd/Tiewsarticle.dtd</DTD> 
<DTD>http: //franklinserver/dtd/productpage.dtd</DTD> 

</ROLE> 
</ROLES> 

To define new users, edit the file conflgDir/users.xml by importing the DTD configDir/users dtd 
to an XML editor. j <^ - 



The DTD users.dtd: 

<! ELEMENT USERS (□SER*)> 

<!ELEMENT USER (NAME, EMAIL, RASSWQRD, ROLE+)> 

<! ELEMENT KAME (#PCDATA}> 

<! ELEMENT EMAIL (#PCDATA}> 

<! ELEMENT PASSWORD (#PCDATA) > 

< ! ELEMENT ROLE ( # PCDATA ) > 

An example users.xml defines two users, each with one or more roles. 

<?xi!a version==''1.0" encoding'=*"UTF-8-?> 
<USERS> 
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<USER> 
<WAME>Joe Moe</NAME>. 
<EMATL> joeQus . ibiTt- cora</EMAIL> 
< PAS S WORD> j oe < / PAS S WORD> 
<ROLE>FLagmentEctitor</ROLS> 
<ROLE>Editor</ROLE> 

<:/USER> 
<OSER> 
<NAME>aane Mane</NAME> 
<EMAIL> jane@us . ibm . coin</EMAIL> 
<PASSW0RD>jane</PASSWORD> 
<ROLE>Editor</R0LS> 
</USER> 
<USER> 
</USER5> 

When the Franklin server is initialized, the Dispatcher module runs GlobalsJoadinfoO^ This 
method merges users.xml, roles.xml and dids.xml into one DOM in memory for fest access. The 
method vcriHes thai all roles named in users.xml have a definition in rohs.xmL It also verifies 
that all DTDs named in roles,xml are defined in dtds.xml and exist in the named directory. If any 
discrepancies are detected, the server prints out a warning message. (Future: the verification still 
needs to be implemented.) 

(Future: if any of the configuration files have changed after the server was last initialized, the 
files will get reloaded and the DOM will get refreshed. This will not have an effect on any users 
currently logged on.) 

Editor Interface & Dispatcher Communication 

After installing the Editor User Interface application and completing the customization described 
in Section Install Franklin Client, launch the application from the Franklin Editor icon on the 
desktop. 

All communications between the Editor UI and the Franklin Dispatcher fol/ow the WebDAV 
protocol. [See the full specification at hltp://www.webdav.org^specs/] 

The HTTP header of a Client request always contains the following attributes with ACTION 
replaced by PUT, GET, LOCK or UHLOCKJranklimervername replaced by the name of the 
Franklin server the client is communicating with, and length replaced by the length in bytes of 
the body section. 

ACTION /filename http/i . i 
Host: frankllnservername 
Content-type: text/xml; charset-"utf-8 " 
Content-Length: length 

The body of the Client request contains the XML document to be checked into the server or a 
DASL search query. 

The HTTP header of the Dispatcher response always contains the following attributes with 
errorcode and message replaced by the standard codes listed in Appendix I . 
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HTTP/ 1.1 srrorcode message 
Content-Type: text/xml,- charset="ut f-Q" 
Content-Length: length 

The format of tiie body of the Dispatcher response depends on the request and whether the 
request was successfully completed or not. 



A special format used for the response follows the DTD below. In the further examples, the use 
of the elements will become obvious. 

<!ELEMEKr RESPONSE (PROCESS, STATUS, ERRORCODE, MESSAGE, SYSTEM?, LCCK?)> 



<! ELEMENT PROCESS 
<! ELEMENT STATUS 

ELEMENT ERRORCODE 
<!E!.EMKNT MESSAGE 
<! ELEMENT SYSTEM 
LASTHODIFIEDTIME, PAGETYPE 
<! ELEMENT FRAGMENTID 
<f ELEMENT CREATOR 

<'elrmh:wt modifier 

<i ELEMENT CRE;ATI0NTIME 

<!ELEMENT LASTMODIFIEDTIME (# PCDATA ) > 

<!ELEMEN-? PAGETYPE f « PCDATA )> 

<! ELEMENT COKTENTSIZE (=» PCDATA ) > 

<! ELEMENT LOCK {LOCKEDBY, 

< r ELEMENT LOCKEDBY (#PCDATA>> 

<!ELaMENT LOCKTIME (# PCDATA ) > 

<!ELEMEN^'r LOCKTOKEN {# PCDATA } > 



{#pcdata; > 

(# PCDATA) > 
(# PCDATA) > 
(#PCDATA)> 

(FRAGMENTID, CREATOR, MODIFIER, CREATIOKTIiMS, 
, CONTENTSI2E?) > 
C# PCDATA) > 
(f^ PCDATA) > 
(# PCDATA) > 
(#PCDATA) > 



LOCKTIME, LOCKTOKEN?) > 



Login 

The editor logs in using the user name and password defined by the Frankhn administrator, ; 
defined in Section Define Roles & Users. 

Client request: 



GET /Km t /frankiin_init.xinl HTTPl . 1 
Ho3t : f ranklinserver/franklinsexvlet 
Contenc -Type : text/xml; charset="utf-8** 

Authorization: "Basic " + encode Base64 (username ^ " + password) 

If the user name is not defined or if the password is entered incorrectly, the dispatcher responds 
with the appropriate error. Dispatcher response: 

HTTP/1. a 401 SC_UNAOTHORIZED 
Content-Type: text/xml; char3et="ut f-8" 
Content-Length: length 

<7xinl version""! . 0'*?> 
<RESPONSE> 

<PROCESS>login</PROCESS> 

<STAT[JS>4 01|</STATUS> 
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<ERR0RC0DE>D1 0 1 < /ERRORCODE> 

<MESSAGE>Qser Joe Doe not defined</MESSAGE> 
</RESPONSE> 

If login succeeds, as described in Section Dispatcher: Session Management, the Dispatcher adds 
the user to the currentusers hash table and generates a unique session identifier, sessionld. All 
subsequent requests from the Editor Ul must contain sessionid m the HTTP header. 

The dispatcher responds to a successful login request by generating \}\e franklin Jnitxnd 
documeiit that coiresponds to the user's roles, references the DTDs the user is allowed to edit, 
and specifies the attributes, operators and aJ lowed values for the Search UI. Dispatcher response: 

HTTP/1.1 200 OK 

Content-Type: text/xmi; charset="ut f-8" 
Content-Length; length 
Sessionid: 175a:dc8eOcle306: -8000 

<?xinl veraion="l . 0" encoding=''UTF-'8 " ?> 
<FRANKLIN_INIT> 
<SEARCH> 

<ATTRIBUTELIST> 

<ATTRIBUTE displayname="Ci:eation Date" name = "GREAT lONTlME" 
cla3S'^"Time"/> 

<ATTRIBDTE displ aynaine="La5t Modified Date" 
name=="LASTMODIFIEDTIME" c] ass = "Time" /> 

<ATTRIBDTE displayname=''Creator " naTie="CREATOR" ciass="Naine"/> 
<ATTRI8UTE dispiaynajne="Document Type" narae="DOCTYPE" 
class-"Selectlon" options- "TEXTFRAGMENT | LISTFRAGMENT i IMAGEFRAGMENT j 
AUDIOFRAGMENT j VIDEOFRAGMENT | INDEXGROITP | PRODUCTPAGE ( SOMESERVABLE"/> 

<ATTRIBUTE dispJayname="Page Type" name^^PAGETVPc" 
cla3s-"Selection" options^" Fragment I Servable" /> 

<ATTRIBUTE displ aynajne="Keyword" naine=" KEYWORD" class = ''Text"/> 
<ATTRIBUTE di spJ ayname=»*Category" naine= "CATEGORY" 
la3s="S€lectlon" options=" Netf lnity_8500R | Netfinity 7000 MIO | 
Netfinity_5500_MlO I Netf inity_5600 j Netfinity 5500"/> 
</ATTRIBUTELIST> 
<CLASSLIST> 

<CLASS name="Tln>e"> 

<OPERAT0R naiae= ">="/> 
<OPERATOR name="<«''/> 
<OPERATOR name="="/> 
<VALUE datat:ype="date"/> 
</CLASS> 

<CLASS name=-Integer"> 

<OPERATOR naiae= ">==-/> 

<OPERATOR name="< = 'V> 

<OPERATOR naine=""''/> 

<VALUE datatype="integer "/> 
</CLASS> 

<CLASS name="Kaine*'> 

<OPERATOR name="i3"/> 

<0PERATOR ndme="i3n ' t"/> 

<0PERAT0R name=" starts with"/> 

<VALUE datat;ype='"string*V> 
</ClASS> 
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<CLASS name="Text"> 

<0PERATOR name="is"/> 

<0PERATOR naiae=" starts with"/> 

<VALUE datatype = *'3tring"/> 
</CLASS> 

<CLASS name="Selection"> 

<OPERAT0R name="is"/> 
<OPERATOR najae="i3n*t"/> 
<VALOE datatype="choice"/> 
c/CLASS> 
</CLASSLIST> 
<R£:SUI.TS> 

<ATTRIBUTE clispIayname-"Last Modified Date" naine=''LASTM0DIFIEDT2ME" 
cia33='*Time"/> 

<ATTRIBUTE displaynaiae="Creator " name- ''CREATOR" cla33-"Name"/> 
<ATTRIBaTE displayname='*Titl6" name="TITLE" class="Text"/> 
<ATTRIBOTB di splayname="Docum6nt Type** nanie-"DOCTYPE" 
la ss=**Sg lection" /> 
</RESaLTS> 
c/SEARCH> 

<ROLE name=»FraginentEditor" displayname^" Fragment Editor"> 
< FRAGMENTS di spl ay name= « Fr agmen t " > 
<DTD di3playname='"Text" 

href-^http://franklinserver/franklin/cltd/textfragment.dtd"/> 
<DTD displaynartie="List" 

href-"http://franfcliTiserver/franklin/dtd/listfraginent.dtd"/> 
<DTD di spl aynaitie*" Audio" 

href="hctp://franklin3erver/franIclin/dtd/audiofraginent.dtd"/> 
<DTD displayname="Video" 

href='^h- tp://fran)clinserver/franklin/dtd/videofragment.dtd"/> 
<DTD dispiayname ="1111396" 

href="http://franklin3erver/franklin/dtd/iraagefragirient.dtd"/> 
</FRAGMENTS> 

</HOI.E> 

<ROL£ name="Editor" displayname='''Editor **> 
<FRAGMENTS di3playname="Fragnien t " > 
<DTD displayname=*'TGxt" 

href=-hrtp://franklinservex/franklin/dtd/textfragment.dtd"/> 
</FRAGMENTS> 

<SERVABLES displayname="Page"> 

<DTD di spl ayname= "News Article" 
href="ht tp: / /f ranklinserver/f ranklin/dtd/newsarticle . dtd" /> 
<DTD di3playnajne-"Product Page" 

href-"ht;tp://franklin3erver/franklin/dtd/productpage dtd"/> 
</SERVAaLES> 
</ROLE> 
</FRArJKLTN INIT> 



From ^xsfranklinjmtxml document, the Editor UI builds the File > New Fra^ient and File 
>New Page menus. It also maintains the mappings between display names and DTD URLs in a 
hash table. 

Tlie Editor UI can be set to load all DTDs at this point, if it is important to enable oJf-line 
editing. We have chosen to load a DTD from the server upon demand for a faster startup process. 



24 



PACE 25/41 • RCVD AT 4/14/2005 2:18:43 PM [Eastern Daytlght Time) • SVR:USPTO-EFXRF-1/8 • DN1S:872930S « CSID:561 980 9812 " DURATION (mm-ss): 14-30 



04/14/2005 14:15 561-989-9812 



FLEIT KAIN ET AL. 



PAGE 26/41 



At this point, the editor is able to either create new content or search for existing content in the 
system. 

Create new content 

The File > New Fragment menu lists all fragments and the File > New Page menu lists all 
servable pages the editor is allowed to create or edit. If the editor selects to create a new 
fragment, e.g. a TEXTP R AGMENT, the Editor UI gets the DTD from the appropriate URL and 
automatically generates a template from the DTD, as shown below: 

[rnclude screenshot here] 

In parallel, the Editor UI maintains in memory a DOM corresponding to the DTD. 



Editor UI Widgets 

The Editor UI uses the DATATYPE attributes in the DTD to generate the appropriate Java 
widget in the user interface. I f an element does not contain a DATATYPE attribute no input is 
allowed for that element Children elements may still contain DATATYPE attributes to specify 
their user mterface. The mapping between Franklin UTTYPEs and Java widgets are given below: 

date => JtextField 

integer => JtextField 

string => JtextField 

shorttext => JtextArea (scrolling) 

longtext => JtextArea (scrolling) 

choice => JCo.TiboBoxCwitn Def aultComboBoxModel to hold the data) 

browselocal => JtextField (with JfileChooser to select local file) 
browseserver JtextField fwith custom JFrame to browse server 

directory) 

Each Java widget is encapsulated in a set of classes that include additional functionality. For 
example, if an element in the DTD is required, e.g. TITLE, the widget will be highlighted (e.g. 
colored brightly) to help the editor distinguish which fields must be filled in. If an clement can 
appear more than once, e.g. KEYWORD, buttons appear next to the widget that allow 
duplicating the widget or group of widgets. 

BODY tags are handled specially within the system. The system assumes that BODY tags are 
composed of 1 or more PARAGR APH tags. Typically, this is represented by a longtext widget in 
the user interface. Blank lines fn the input are interpreted as paragraph separators. When 
constructing the DOM object, these paragraphs are composed within the outer BODY tag. 

Check-in of New Fragment 

When the editor has filled in the template in the UI, clicking on the check-in icon verifies that all 
required elements are filled in. If so, the DOM in memory is populated with the data in the UT 
widgets. New nodes are added if new instances of an element have been created using the +A 
buttons. Nodes arc removed from the DOM if optional fields have not been filled in. Once the 
DOM mirrors exactly the UI, the document is transformed to an XML string and a request is sent 
to the Dispatcher with the XM L as the body. 
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Note that the only time a check-in request to the Frankiin Dispatcher does act include the file 
name contain ing/ragw/e/rf/^ is when uploading a new fragment. The absence of a fragmentid 
indicates to the server that a new, unnamed fragment is being checked-in. The Dispatcher assigns 
I jLJnique ids to ail fragments. 



Client request: 

Ptrr fragmentid HTTPl.l 
Host : f ranklinserver/f ranklinservler 
Concent-Type: text/xml; charset=*utf-e*' 
SeasionJct: 175a :dc8e0de306:-e000 
Conte.it-Length : length 

<?xinl version«"l . 0"?> 
<!DOCTYPE TEXTFRAGMSNT SYSTEM 

"http://adtech.ibmu32.ibm.coin/frankiin/dtd/textfragment.dtd'' > 
<TEXT FRAGMENT> 

<SYSTEM> 

< FRAGMENT I D/> 

<CR£ATOR/> 

<MODIFJER/> 

<CREATIONTIME/> 

<LASTMODIFIEDTIME/> 

<PAGETyPE/> 

<COKiTEWTSIZE/> 
</SYSTEM> 

<TITLE>This is the title of this t ex t; fragment </TITLE> 



<?ARAGRAPH>Thi3 is the document body</PARAGRAPH> 
</BODY> 
</TEXTcai^GMENT> 

If check-in is successful the Dispatcher returns the SYSTEM data of the XML document filled in 
wi^ the newly created unique/rargroentfi/, and the authoring information, as described in Section 
XXX. The client merges the SYSTEM tag into the existing XML document. The Editor Ul now 
has the complete XML. 

Dispatcher response: 

HTTP/1 . 1 200 OK 

Content-Type: text/xml; char3et="utf -S" 
Content-Length: length 
Sessionid : i75a : dc8e0de306 : -8000 

<?xml version='*l .0''?><RESPONSE> 
<PROCKSS>new Checkia</PROCESS> 
< STATU S > 2 0 0 < / STATUS > 
<ERR0RCCDE>OK</ERR0RC0DE> 
<MESSAGE>OK</MESSAGE> 
<SYSTEM> 

<FRAGMENTID>46ba850dcecflf3cl007f33-Tfrg.xiiil</FRAGMENTID> 
<CREATOR>Joe Doe</CRE:ATOR> 
<MODIFIER>Joe Doe</MODIFIER> 

.<CREATIONTIME>2000-0l-O7-14 .08.09. 32B000</CREATIONTIME> 
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<LASTM0DIF1 EDTIMEi /LASTMOD I r I EDTrME> 

<PAGETYPE>Fraginent</PAGETYPE> 
<CONTENTSIZE>537</CONTENTS12E> 
</SYSTEM> 
</RESPONSE> 

If the fragment about to be checked in has an accompanying content file, i.e. a multimedia asset 

or an XSL style sheet, the Editor UI encodes the contents using Base64encodiag into the 

CONTENT element in the XML. On the server side, the Dispatcher iin-encodes it and writes the 

file to the file system, as described in Section XXX. This method avoids sending multiple 

requests to the Dispatcher and having to maintain state between two requests. 

Caveat: presently we are unclear on whether there is a size limitation to this method! And it is 

slow! 



Check-In of Modified Fragment 

If the Editor UI checks in a modified fragment or page, it vnU have received a locktoken from 
the Dispatcher before checking it out. The check-in request in this case must include the 

LockTocken header field ^ { Peieteci7 

Client Request 

PUT fragmentid HTTPl . 1 

Host; f ranklinserver/franlclitiservlet 

Content-Type: text/xirJ; charset=**ut f-8" 

Se.*53ionId: I75a : dc8eOdG30S : -8000 

Content-Leagthr length 

LockTocken: 



The dispatcher verifies that the correct lock token is supplied with the PUT request before it 
processes the request The dispatcher changes the MODIFIER and the LASTMODIFIEDTIME 
fields in the SYSTEM element. 

After the check-in command, the Editor UI issues an unlock command using the appropriate 

LOCKTOKEN. 

Client request: 

UNLOCK /12345678-tfrg.xmJ HTTPl. 1 
Host: franklinserver/f ranklinservlet 
Sessionid « 175a :dc8e0de306: -8OO0 
Locktocken = 12345678 



The Dispatcher verifies the locktoken as described in Section XXX, and returns an OK if the 
token is correct, otherwise it sends one of the two Franklin lock errors: 

# LlOl = Lock tokens do not match 

# L102 Missing locktoken 
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Check-out 

To check out a fragment for editing from the Franklin Server, the Editor UI first requests a lock 
for the given fragment, as defined by the WebDAV protocol. 

Client request: 

LOCK /1234S678-tfrg.xna HTTPl.l 
Host : f ranklinserver/f ranklinservlet 
Sessionid = 175a: dc8eOde306: -8000 

If the fragment is already locked by anoth^ user, the dispatcher returns a response with 
information on who has locked it when, in case the user wants to contact the person who holds 
the lock. 



Dispatcher response: 

HTTP/1.1 |^iil[OK^ _ 

Content-Type : "text/xml; chars"et="utf-a^ ~ 
Content-Length: length 
Sessionid: 175a;dc8e0de306: -8000 



<?xinl version="l . 0"?> 

< RES POMS E> 

<PROCESS>LocJc</ PROCESS > 
<:STATDS>200</STATUS> 
<ERRORCODE>0K</ERR0RC0DE> 
<MES SAG E> LOG ked< /MESS AGE> 
<LOCK> 

<LOCKEDBy>Jane M^no*- /t />r.j^£.Qpy^ 
<LOCKTIME> 
</LOCK> 
</RESPONSE> 



'LOCKTIME> 



If the fragment is not already locked and if the user with the sessionid is allowed to edit 
documents based on the DTD of the requested fragment, the dispatcher creates a unique lock on 
the firagment as described in section Dispatcher: Lock Management. It also sends the lock token 
back in the response. 

Dispatcher response: 

HTTP/1.1 200 OK 

Content-Type: text/xml; charset^^ut f-8 " 
Content-Length: length 
Sessionid: I75a:dc8e0de306 :-8000 



<?xml version="1.0"?> 
<RESPONSE> 

<PROCESS>Lock</PROCESS> 

<STATUS>200</STATUS> 

<ERR0RCODE>OK</EE^0RCODE> 

<MESSAGE>OK</MESSAGE> 

<LOCK> 

<LOCKEDBY>Joe Moe</LOCKEnRY> 
<LOCKTIME> 

<LOCKTOKEN>12345678</LOCKTOCKEN> 



./L0CKT1ME> 



2S 
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<:/LOCK> 
</RESPONSE> 

Now the Editor Ul can request the fragment for editing using the lock received from the server. 
Ghent request: 

GET /12345678-tfrg.)CTra HTTPl.l 

Host: f ranklinserver/f ranklinservlet 

Content-Type: text/xml; charset-"utf-8" 

Locktocken = 12345678 

Sessionid = 175a:dc8eOde306: -8000 

The Dispatcher compares the lock to the one saved in the Meta Data Store. If they match, 
Dispatcher responds by sending back the complete XML of the fragment. 

Dispatcher response: 

HTTP/1.1 200 OK 

Content-Type: text/xmX; char3et=^'*utf -8" 
Content-Length : length 
Sessionid: 175a:dc8e0de306 : -8000 

<?xml version=»**l , 0"?> 

<!DOCTYPS PRODUCTPAGE SYSTEM "ht tp; //f ranJclinserver/dtd/oroduc tpage . dtd" > 
< PRODUCT PAGE> 
<SySTEM> 

</SYSTEM> 

</PROD0CTPAGE> 

The Editor UI retrieves the DTD of the checked-out fj-agment from the server if it has not yet 
loaded it. Using the DTD it auto-generates the UI widgets and then fills in the existing values 
from the checked-out fragment, adding new instances of elements using the mechanism when 
necessary. 

The editor can modify the fields in the same way as when creating new content. Upon check-in 
the Dispatcher updates the lastmodifedtime and modifier fields in the system data of the 
checked- in XML document. 

Search . 

Clicking on the Search icon in the Editor Ur brings up the Search dialogue shown be?ow: 
[insert Search screen shot here] 

When launched, the Search dialogue parsesJranMinJmtxml and stores anributes, operators and 
allowed values into hash tables. It dynamically generates the widgets for the query composition. 
When new attributes or values are added to frartkiinJniLxml, the Search code does not need to 
be updated. 

The Search UT communicates with the Dispatcher using the Distributed Authoring Search 
Language (DASL) [add ref], an extension to the WebDAV protocol. Franklin Server defines the ' 
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"Franklin" name space which allows the insertion of properties that correspond to the names of 
the indexed elements in Franklin Meta Data Store. 

An example of a DASL exchange between Search UT and Dispatcher is shown below for the 
example Boolean query: 

{AND 

( PAGET YPE "is" "Fragment") 
{LASTMODIETEDTIME "gte" " 
■CRfiATOR "is not" "Jeff Milton")) 



Search request: 

SEARCH / HTTP 1.1 

Host : f ranJtlinserver/franklinserviet 
Copteni.- Type : text/xml; char3et="utf -8" 
Sessicnid = 1 76a :dc8e0de306: -8000 



<?xni.l '.'eraion="l . 0"?> 

<d:searchrequest xmlns : d='*DAV : " xmlns : f=*'Fran)clin : "> 

<d : baL;lcsearch> 
<d:select> 
<d : pj:op> 

<f : FRAGMENTlD/> 
<f :DTD/> 

< f : LASTMODI FI EDTIME/> 
<f :TITLE/> 
<-.f : CREATOR /> 
< /d ;prop> 
< /d : :=ielect> 
<d : Tr om> 
<d: scope> 
<d: href /> 

<d: depth>infinity</d:deptb> 
:scope> 
</d ; f rom> 
<d :vjher e> 
<d: and> 

<u : eq> 

<d:prop> <f :PAGETyPE/> </D:prop> 
<d:literal>Fraginent</D: literai> 

</d :eq> 

<d;gte> 

<d:prop> <f :LASTM0DIFIEDTIME/> </D:prop> 
<d:literal>1999-10-10</D:iiteral> 

</d:gte> 
<d : not> 
<d : eq> 

<d:prop> <f:CREATOR/> </D:prop> 
<d:literal>Jeff Mllton</D: li teral> 
</d: eq> 
</c : not> 
</d :.ind> 
</d: where> 
<d:lirr.ir> 
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<d:nresults>2</d:nre3ul ts> 
</d:iind.t> 
< /d : ba s ic s ea r ch> 
</d: 3earchreque3t> 



The Dispatcher passes the query to the Meta Data Store where the query is converted to SQL and 
executed against DB2. The results are converted back to the DASL format 

Currently, we are using the d:nresufts tag to indicate a range of results to be returned, {e.g. 
<d:nresults>l-50</d:nresults>) This enables the chent to request subsequent "pages" from a 
search with a large number of results. 

Dispatcher response: 

HTTP/1.1 207 Multi-Status 
Content-Type: text/xml; charse t="utf-B" 
Content-Leiigth: length 



Kialns : f="Franklin : "> 



<?xml version="l . 0''?> 
<d rmultistatus xmlns :d=^DAV: ' 
<f 2responsesuinmary> 

</f : responsesuiainary> * 
<d:re3pon3e> 

<d: href >http://franklin-acitech.ibm.com/43987548-tfrg.xml</d: href > 
<d:propstat> 

<d:prop> 

<f :FRAGMENTID>4 3987548-tfrg.xml</f :FRAGMENTID> 

< f : DTD>r e x t f r £iy men t < / f : DTD> 

< f : PAGETYPE > Fr agmen t< / f : PAf;ETYPK> 
<f :LASTM0D1FIEDTIMB>; 
</f :LASTM0D1FIEDTIME> 

<f:TITLS>Lou Gecstner's bio</f :TITLE> 
<f :CREATOR/>Joe Moe</f :CREATOR> 
</d:prop> 
</d:prop3tat> 
</d:response> 
<d : response^ 

<d:href>http://franlclin.arir^ch.ibm.coin/9999999-frg.xml</cl:aref> 
<d:propst:ac> 

<d:prop> 

< f : FRAGMENT I D> 9 9 9 9 9 9 9 - t f r g . xml< / f : FRAGMENT I D> 
<f :DTD>Li3tfragmenc</f :DTD> . 
<f :PAGETYPE>Fracinent</f : VAny.'rvw.^ 

< f : LASTMODI Fl HIDT IME> 
< / f ; LASTMODI FI SDT T ME> 

<f :TITLE>Highlights for Netfinity 8500R</f : TITLE> 
<f :CREATOR/>Jane Mane</f : CREATOR> 
</d:prop> 
</d : props tat> 
</d: responso 
</d:miiltistatus> . 
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The Search UT parses the results and displays them in the results table. From the table, the editor 
can select items and merge them into the Active List in the Editor U\. 

Future: If more than the requested number of iiits exist in the database, the Search UI uses the 
RESPONSESUMMARY element in the result list to determine how to manage the ''Next** and 
"Previous" buttons that allow further results or to go back to a previous set of results. 

Preview 

Before checking in a servable, the editor can preview the final page to be published. The preview 
icon in the Editor Ul is aaive only v^en editing a servable. Requesting a preview sends a 
request to the Preview Manager servlet with the temporary contents of the servable XML. The 
Preview Manager expands the servable with contents of any subfragmenls, assembles the page 
with all included style sheets using LotusXSL, and returns the resulting HTML output to the 
client. 

The Editor UI launches the web browser specified in the franklm,properties file and displays the 
temporary output. Once satisfied, the editor can check in the servable. Servables previously 
checked in (e.g., servables returned as search results) can also be previewed. 

(Future: preview of an HTML page does not indicate to the editor which fragment produced any 
given area of the page. Need to devise a way to display the source element.) 

Dispatcher 

Session Management 

When a user logs on using the Editor UI, as described in the Section Editor Interface & 
Dispatcher Communication: Login, the dispatcher checks for a valid user and password by 
consulting the DOM, generated at startup, which contains all user information. If they are valid, 
the dispatcher adds the user to the currentusers hash table and generates a unique session 
identifier, sessionld, Sessionld is created using the java VIDQ call that guarantees to return a 
unique identifier for the machine the process is running on. 

If the same user logs on a second time fix>m another terminal without terminating the earlier 
session, the earlier sessionld in overwritten by a new one, and the old session becomes invalid. 

At logout, the users entry is removed from the currentusers hash table. 

Future: the class that manages the user sessions must be serializable, so that its state can be 
saved and reloaded if the Franklin Server servlet needs to be restarted. 

System Data Creation 

When a dispatcher receives the check in request from the Editor UI, it handles new and modified 
fragments differently. 
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For a new fragment, the Dispatcher fills in the following so-called system elements in the DOM 
built from the incoming fragment: 

<SYSTEM> 

<FIU\GMENTID>4 6baa50dc8cf lf3cl007f33-tfrg.xml</FRAGMENTID> 
<CREATOR>Joe Doe</CREATOR> 
<M0DIFIER>JOG Doft</MOnTrTRP> 

<CREATI0NTIME>; /CREATIONTIME> 
<LASTMODrFIEDTIKE> XASTM0DIFIEDTIKE> 
<PAGETYPE>Fraginent</PAGETYPE> 
<CONTENTSIZE>537</CONTENTSIZE> 
</SYSTEM> 

FRAGMENTiD IS the Unique identifier for the fragment This identifier is created using the Java 
U!D(} call which returns a guaranteed unique identifier for the machine where the process is 
running. To the UID, the dispatcher appends the suffix -tfrg.xml for simple fragments, -bfrg.xml 
for compound fragments, or -tsrv.xml for servables. To know which suffix to append, the 
dispatcher consults the dtdT oType hash table, built at startup to cache the mapping between 
DTDs and their types. 

CREATOR is the name of the user who originally checked in the new fragment The dispatcher gets 
this name by calling the sessionidToVser method, which retrieves the user name from the 
cw rentusers hash table based on the sessionid, 

KODi FiER is the name of the user who is currently checking in the fragment modifier and 
CRSA i OR are the same when creating the system data for a new fragment 

CREATiONTiME is the Java generated time stamp of the system data creation time at original 
check-in. 

i^sTMODi FiEDTiME IS the Java generated time stamp of the system data update time at 
subsequent check-ins. CREATIONTIME and lastmodifiedtime are the same for a new 
fragment 

pagetype is set to either "fragment" or "servable". The dispatcher sets pagetype by 
consulting the dtdToType hash table, built at startup to cache the mapping between DTDs and 
their types. This field is important because processing of fragments and servables is different in 
the liditor UJ as well as in the content store module. 

ccK TETaTSizE is the sizc in bytes of the checked-in fragment including any included binary data. 
The dispatcher calculates this after filling in the system data but before extracting any binary 
data. Thus, this is the size of the string being sent over the network between Editor Ul and the 
dispatcher. 

Name Space Management 

The name space manager module of the dispatcher manages all reading and writing of files. It 
abstracts away the actual file system from all other modules, so that they do not have to keep 
track of specialized directories. 
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The name space manager provides the functionality to read and write into the file system DOMs, 
corresponding XML strings that represent fragments or servables. At dispatcher startup, the 
initialization file is read in, and the variables defining the directories become available to the 
name space manager. 

When writing a compound fragment, the name space manager also extracts any encoded 
multimedia tiles and style sheets and writes them into the appropriate directories. On the other 
hand, when reading a compound fragment, it encodes any external files into the XML and 
returns the DOM to the module requesting it. 

In addition to the dispatcher, the content store uses the name space manager as well. The content 
store uses it to read fragments from the file system and to write HTML/HDML/DHTML output 
files from page assembly into the file system. 

The advantage of separating the name space manager from the rest of the Franklin server is to 
isolate the knowledge aboirt dedicated file system directories to one module. For example, if 
xmlDir needed to be split up into a series of second-level directories to limit the size of any one 
directory, only the name space manager would need to know about the change. Under xmlDir 
could reside 10 child directories 0/, 1/, ...9/ and a fragment would be stored in one of them based • 
on a load-balancing algorithm handled by the name space manager. 

Coordination Between ModuJes at Check-in 

[describe the 3 phase save to file system, mela store and tm, with the fact that tm is 
asynchronous. Maintenance of pending jobs table by dispatcher, and roll-back] 

Lock Management 

As described in the sections Editor Interface & Dispatcher Communication; Check-in and 
Check-out, the Editor Ul and dispatcher exchange lock tokens during the LOCK and UNLOCK, 
requests from the Editor UT. 

When the dispatcher issues a lock token, it uses the Java UfDQ call to create a unique identifier. 
It sends the token along with the user name and the lock time to the Editor UI in the body of the 
response and stores another copy of this information in the meu-data store as described in the 
section Meta Data Store: Lock Management. 

When the dispatcher receives an U^a.OCK request with a lock token from the Editor UI. it needs 
to verify that the token matches the one stored in the meta-data store. If they match, the 
dispatcher issues a call to delete the lock in the meta-data store. 

The dispatcher has two other ways to manage locks if problems occur. If the Editor UI requests 
that all locks held by the current user be released, the dispatcher issues the call 
relaaseLockByUser to the meta-data store. When the dispatcher is restarted due to a systOT 
crash, all pending locks in the meta-data store can be released at startup with the call 
releaseLockAU. 
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Error Handling 

All Franklin server side components abide to the same Franklin error handling scheme. When 
any of the components called by dispatcher, namely meta-daia store, name space manager, user 
manager, or content manager, catch or throw a Java exception, they convert it to a Franklin 
exception and fill in all details about the context and the conditions where the error occurred. 

A Franklin exception contains the following attributes: 

myError - the Franklin error code 

myHitpError - the HTTP error code corresponding to the Franklin error code 
niyMessage - explanation of error, presented to user of the Client application 
myDestination - one of ERROR_lJSER, ERROR^LOG, ERROR_ADMlN to indicate 
where the error should be directed 

myException - the originally caught exception, if there is one 

The dispatcher module roiUes the exception based on the attributes. If myDestination is set to 
ERROR USER, the dispatcher returns the exception to the Editor UI which displays the error to 
the user. If it is set to ERROR_LOG, the error is written to the error log file, and for 
ERROR ADMIN, the process notifies the system administrator. 

Meta Data Store 

The meta-data store allows the indexing and searching of fragments and servables. All or a 
subset of the XML elements can be set to be indexed. For a large content site this allows users to 
quickly locate content objects of interest, fhe meta-data store also manages the lock information 
of content objects- 

DB2 XML Extenders 

Franklin uses XML Extenders for DB2 to index a subset of the XML elements of fragments and 
servables. To accomplish Indexing, XML Extenders uses a Document Access Definition (DAD) 
that maps an XML element to a column in a i:)B2 table. 

DB2 XML Extenders provides two different methods, namely XColumn and XCoi lection. We 
have inrtplemented both methods in Franklin and decribe both in this document. We recommend 
usmg the XCollectlon as it is more flexible. 

XColumn 



The current XColumn implementation of XML Extenders can only map one DTD to one or more 
DB2 tables. In order to map all Franklin DTDs to one or more common tables, the dispatcher 
converts all DTDs to a so-called universal DTD, which contains all elements to be indexed in the 
set of DTDs. For this universal DTD, two DA Ds are created based on the XML Extender 
syntax. 

Two DADs are needed, because the current XColumn implementation does not support inserting 
elements that occur only once in the XML and those that occur more than once using a single 
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DAD. Th\2S, the examples in this section show two DADs that map values from the universal 
DTD. 

When designing the DADs, all elements that appear only once» or single-occurrence elements, 
can be mapped to one table. Any elements that can appear more than once, or multi-occurrence 
elements, need to be mapped each into separate dedicated tab^es. The administrator creates a 
view between the single-occurrence table and the multi-occurrence tables to perform searches 
across all tables with one command. 

A DAD specifies the foltowing items: 

table name = name of the DB2 table 

column name - name of the column in the encapsulating table 
column type = data type of the column 

column path = XPath expression from the root to the elemeni: to be indexed 
in the column 

column multi-occurrence = ii.-jg to indicate whether the element at the path 
can occur more than once 

Example of a DAD mapping single-occurrence elements: 
<?>tml ver3ion=»"l . 0"?> 

<!DOCTYPE DAD SYSTEM "c : \dxx \ f ran ki in\dtd\\iniversal . dtd"> 
<DAD> 

<dtdid>ONIVERSALDTD</dtdj d> 
<validation>NO</validation> 
<Xcolumn> 

<table name="HETA.MAIN"> 
<column name- "CHEAT OR" 
type=''varchar (50) " 

path="/nNlVERSAL/SYSTBH/CREATOR" 
multi_occurrence-"NO"> 
</column> 

<column name="CREATlOMTlME:" 
t ype= " T IMESTAMP " 

path="/UNIVERSAL/SYSTE:?^/CREATIONTIME" 
multl ocjcurrence="NO'*> 
</column> 

<column name="LASTMODTFiEDTiME" 
type^'^T IMESTAMP" 

path="/UNIVERSAL/SYSTEM/LASTMODrFIEDTIME" 
multi_occurrence'= "KO'*> 
</column> 

<coluTttn name=*PAGETYPE" 
type=*'char (10) " 

pa t h=" /ONI VERSAL/ SYSTEM/ PA GETYPE" 
multi_occurrence-"NO"> 
</column> 

<column name="CONTENTSTZE" 
type=" integer" 

path="/0NIVERSAL/SYSTEM/CONTENTSI2E" 
mul ti_occur rence= "NO " > 
</coluinn> 

< column name= "TITLE" 
type- "varchar (250) " 
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path=" /UNIVERSAL/TITLE** 
iDUlti_occurrence="NO"> 
</column> 

<coluinn name-'*DOCTYPE" 

type=*'varchar (32) " 

pa th« "/UNI VERSAL/ DOCT Y PE'' 

multi_occurrence="NO''> 
</coluian> 

<coluinn name="DTDaRI*" 
type«"varchar ( 512 ) " 
path="/ONrVERSAL/DTDURL" 
multi_occurrence="NO"> 
</coluinn> 
</table> 
</Xcolumn> 

Example of a DAD mapping multi-occurrence elements: 

<?xml version^"! . 0"?> 

<!DOCTYPE DAD SYSTEM "c : \dxx\ franklin \dcd\univer sal . dtd"> 
<DAD> 

<dtdid>UNIVERSALDTD</dtdid> 
<validation>NO</vaiidation> 
<Xcol\iran> 

<table name="META. GATE GORY 
<coluirin name*" "CATEGORY" 
type="varchar ( 12B ) " 
path-" /ONI VERSAL/CATEGORY" 
inulti_occurrence='' YES " > 
</column> 
</table> 

< table naine=^''META.KEYWORDV> 
<coluitm naif>e="KEywORD" 
type""varchar { 64 ) " 
path«" /UNIVERSAL/KEYWORD" 
mul ti__occur rence= " YES " > 
</coli-imn> 
</table> 
</Xcolunm> 
</DAD> 

The tables created by these DADs are shown ia the Section Table Design. 
XCollection 

The XCollection implementation of XML Extenders requires one DAD for each DTD to be 
mapped into DB2. Unlike XColumn, different DTDs can be mapped to the same DB2 tables. 
Thus, the XCollection implementation does not required documents to be convened to abide to 
one universal DTD. 

[However, the current XCollection also has a few problem. We have implemented a temporary 
fix into the meta data store \intil the problems are addressed] 

The DAD corresponding to textftagment^dtd is shown below: 
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[add DAD here] 



Table Design 

When a DAD is loaded into DB2» the tables and columns specified in it are automatically 
created. After the tables are created, the administrator needs to add the following items to the 
database: 

- a column named ISCOMMIT in the table storing the single-occurrence elements. This 
column indicates if the fragment has successfiiliy. been committed to the content store 
and file system 

- indexing on any columns that will be searched 

- a view which combines data from all tables for searching 

The database tables created by the previous DAD examples are shown below, along with keys, 
indexes, and the TSCOMMIT column created by the administrator. 

Schema : 

META: Osed for all the tables used by Franklin 
INDEX: Used for all the indexes used by Franklin 

Tables Generated by DAD; 

META. MAIN: This table contains all the elements that occur at most once in 
the input XML document 



Column Name 

FRAMENT3 D 

CREATOR 
CREATIONTTME 

LASTMODIFIEDTIME 

C0NTENTSI2E 

TITLE 

PAGETYPE 

DOCTYPE 

DTDURL 

ISCOMMIT 



Data Type 

CHAR(36) 

VARCHAR(50) 
TIMES TAMP 

TIMES TAMP 

INTEGER 
VARCHAR 
CHAR(IO) 
VARCHAR (32) 

VARCHAR (512) 
INTEGER 



Default 



Key 

Fk -> 
unif ragl 



Index 

index . fragment 
id 

index . creator 
index . creation 
time 

index . lastmoda 
f iedtime 

index* title 
index. pagesize 
index . doc type 
index. dtdurl 



META. KEYWORD: This table contains the KEYWORD elements associated with a 
given FRAGMENTID: 



Column Name 
FRAMENTID 



Data Type 
CMAR(56) 



Default 



Key 

Fk -> 
unif rag2 



Index 

index, fragment 
ed 
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KEYWORD VARCKAR(64) index . keyword 

META. CATEGORY: This cable contains the CATEGORY elements associated with a 
given FRAGMENTID. 

Column Name Data Type Default key index 

FRAMENTID CHAR (56) fk index . fragment 

id 

CATEGORY 

VARCHAR (128) index. category 

UNIFRAGl: This table contains two fields, 

Fragmentid - the fragmentid for a given XI^L file 
Fragmentxtra - the XML file stored in the file system 
The function of this table is no trigger filling META. MAIN when a record is 
inserted 



Column Name Data Type * Default key index 

FRAMENTID CHAR (56) PK 

FRAGMEafTXML 

DB2XML .XMLFILE 

UNIFRAG2: This table has the same structure aa DNIFRAGI. The function is to 
trigger filling META. KEYWORD and MET A . CATEGORY when a record is inserted 

Colimn Name Data Type Default key index 

FRAMENTID CHAK(56} PK 

FRAGMENTXML 

DB2XHL,XKLFILE: 

Index 

When a fragment or servable is checked in, the dispatcher converts the XML file to abide to the 
universal DTD for indexing in the XColumn implementation. After the conversion, it sends the 
universal XML to the meta-data store. In the XCollection implementation, the fragment or 
servable is sent as is to the meta-data store. 

For XCollection, the meta-data store enters a pointer to the file into the two tables named 
UNiTFRAGl and UNIFRAG2 in the previous example. When the record is entered, a trigger copies 
the elements specified in the DAD to the appropriate tables. The elements are now ready for 
searching. 

For XColumn ... 
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Search 

When the Search UT sends a DASL search expression, described in the section Editor Interface & 
Dispatcher Communication: Search, to the dispatcher it passes it direaly to the meta-data store. 
The meta-daia store converts it to an SQL expression, executes the SQL query and converts the 
results to the DASL output format 

An example DASL query: 

<?xml ver5ion="l .0"?> 

<d:searchreqt:est xnans :d="DAV : " xralns : f = 'Tranklin : "> 
<d:basic3earch> 
<cl:selec!:> 
<t :prop> 

< f : y[lAGMENTID/> 
<f:DOCTYPK/> 
<ti LASTMODIFIEDTIME/> 
<f :TITLE/> 
<f: CREATOR /> 
<f :?AGETYPE/> 
</f :prop> 
</d: seJ ect> 
<d: frorT» 
<d; scope> 
^6 : href /> 

<d : depth>inf inity</d : depth> 

</d:scope> 
</d: f rom> 
<d: where> 
<ci : and> 
<d: .l ike> 
<d : prop> 

<f:KEYWORD/> 
</d:p]:op> 

<d:literai>SERVER</d:litexal> 
</d:like> 
<d:like> 

<d:prop> 

<f : PAGET YPE/> 

</d: prop> 

<d:l lteral>FRAGMENT</d:litera.l > 

</d:like> 
</d:and> 
</d: where> 
<d : limit > 

<drnresults>l-50</d:nresults> 
</d; Jlmit> 
</d:basicsearch> 
</d : 3earchrequest> 

The above DASL query converted to SQL: 
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